using System.Collections.Generic;
using System.Threading.Tasks;
using JGSY.CMS.LowCode.Platform.Domain.Entities;

namespace JGSY.CMS.LowCode.Platform.Domain.Interfaces
{
    /// <summary>
    /// 用户设备仓储接口
    /// 提供用户设备实体的数据访问操作，包括增删改查等功能
    /// </summary>
    public interface IUserDeviceRepository
    {
        /// <summary>
        /// 获取所有用户设备
        /// </summary>
        /// <returns>用户设备列表</returns>
        Task<IEnumerable<UserDevice>> GetAllAsync();
        
        /// <summary>
        /// 根据ID获取用户设备
        /// </summary>
        /// <param name="id">用户设备标识符</param>
        /// <returns>用户设备实体，如果不存在则返回null</returns>
        Task<UserDevice?> GetByIdAsync(long id);
        
        /// <summary>
        /// 添加新的用户设备
        /// </summary>
        /// <param name="entity">用户设备实体</param>
        /// <returns>添加操作的异步任务</returns>
        Task AddAsync(UserDevice entity);
        
        /// <summary>
        /// 更新用户设备信息
        /// </summary>
        /// <param name="id">用户设备标识符</param>
        /// <param name="entity">更新后的用户设备实体</param>
        /// <returns>更新操作的异步任务</returns>
        Task UpdateAsync(long id, UserDevice entity);
        
        /// <summary>
        /// 删除用户设备
        /// </summary>
        /// <param name="id">用户设备标识符</param>
        /// <returns>删除操作的异步任务</returns>
        Task DeleteAsync(long id);
    }
}
